home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / comms / ripspy.zip / RIPSPY.DOC < prev    next >
Text File  |  1995-01-12  |  10KB  |  291 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                RRRRRRR    IIIIII  PPPPPPP
  21.                 RR   RR     II     PP   PP
  22.                 RR  RR      II     PP   PP
  23.                 RRRR        II     PPPPPP
  24.                 RR  RR      II     PP
  25.                RRR   RRR  IIIIII  PPPP     spy
  26.  
  27.  
  28.                           Version 1.01
  29.  
  30.  
  31.  
  32.  
  33.             Remote Imaging Protocol (RIPscrip) Viewer
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.                        Manual and Software
  42.               Copyright (C) 1994 by Zachary G. Ives
  43.                        All Rights Reserved
  44.  
  45.  
  46.    RIPscrip is a trademark of Telegrafix Communications, Inc.
  47.  
  48.  
  49.                      DISCLAIMER AND LICENSE
  50.  
  51.  
  52.      By using this software, you agree to the following
  53. conditions.
  54.  
  55.      The author, Zachary G. Ives, makes no warranty, either
  56. express or implied, with regard to this software.  To the best of
  57. the author's knowledge at the time of release, the program worked
  58. correctly when tested.  It may not work on all machines or all
  59. copies of WWIV.  The author will attempt to rectify any problems,
  60. but can make no guarantees.
  61.  
  62.      The author will not be held liable for the use, misuse, or
  63. failure to use this software.  Any losses or damages, financial
  64. or otherwise, are the sole responsibility of the licensee.
  65.  
  66.      You are licensed to evaluate this program for a reasonable
  67. amount of time, but must "register" it with the author after a
  68. reasonable period of time.  The registration fee of $10 entitles
  69. you to higher-priority technical support, possible discounts on
  70. other products from the author, and a clear conscience.
  71.  
  72.      Under the condition that you do not modify either the
  73. program or its documentation, you may distribute this program in
  74. its entirety to others.  You are encouraged to upload it to other
  75. bulletin boards.  This program may also be distributed on disk,
  76. provided the distributor makes it clear that he/she is charging
  77. only for shipping and handling, and provided the fees are no more
  78. than $5.00 per disk.
  79.  
  80.                       THE RIPspy RIP VIEWER
  81.  
  82.  
  83. BASIC OPERATION
  84.  
  85.  
  86.      It's likely that just about anyone with DOS experience will
  87. be able to use RIPspy without reading the manual.  However, you
  88. might be able to gain something from reading the manual.
  89.  
  90.      The basic syntax is:
  91.  
  92.      RIPSPY <filespec>
  93.  
  94.      where filename is either a pathname to a certain RIP file,
  95. or a wildcard specification.  If you don't give any extension,
  96. .RIP is assumed.  Thus you can do:
  97.  
  98.      RIPSPY HELLO
  99.  
  100. to show HELLO.RIP; or:
  101.  
  102.      RIPSPY \WWIV\RIPMENUS\*.MN?
  103.  
  104. to display all the .MN? files in the \WWIV\RIPMENUS directory.
  105.  
  106.  
  107. FONT AND ICON FILES
  108.  
  109.  
  110. By default, RIPspy expects you to have Telegrafix's RIPterm
  111. installed on your machine, with font files in \RIPTERM\FONTS and
  112. icons in \RIPTERM\ICONS or the current directory.  If this is not
  113. the case, you can use the command SET RIPPATH = {path} to tell it
  114. where to look.
  115.  
  116.      If you have no RIPPATH and no RIPTERM\FONTS or RIPTERM\ICONS
  117. directory, RIPspy will ask you for the correct directories.
  118.  
  119.  
  120. RIP COMMANDS SUPPORTED
  121.  
  122.  
  123.      In general, RIPspy supports nearly all of RIPscrip's
  124. commands with few limitations, as discussed below.  It also
  125. supports the majority of ANSI codes, plus the WWIV BBS program's
  126. color and substitution codes (which begin with ASCII 3 and ASCII
  127. 15, respectively).
  128.  
  129.      One integral feature that most other RIP viewers do not
  130. support is the TTY/ANSI text window.  Normal text or ANSI codes
  131. will be displayed within this window, rather than anywhere else
  132. on the screen.  RIPspy displays the MicroANSI (91x43), normal
  133. (80x43), and 40x25 TTY fonts, in the same font as RIPterm uses. 
  134. For the other (80x25 and 91x25) TTY sizes, it features a font
  135. similar but not identical to RIPterm's.  This should not cause
  136. any problems anywhere, but it does look slightly different from
  137. RIPterm's equivalent font.
  138.  
  139.      RIPspy also has support for the full range of graphics and
  140. clipboard commands, including Beziers, arcs, and so on.  It even
  141. supports the "active text variables" that are part of the
  142. RIP_QUERY command, so you can save text windows dimensions, save
  143. the clipboard to disk, and so forth.  You can even write icons to
  144. disk.  As far as I know, RIPspy is the only RIPscrip viewer which
  145. will do these things.  If any of your screens rely on a saved
  146. clipboard, RIPspy will have no problem in viewing them; while
  147. most other programs would.
  148.  
  149.      Even the RIP_READ_SCENE command, which is used to load one
  150. RIP file from within another one, is supported.  There are only
  151. about four seldom-used commands in the RIPscrip 1.54
  152. specifications which are not fully supported by RIPspy.
  153.  
  154.      As with all RIPscrip viewers, RIPspy does have a few
  155. limitations.  Because it displays ANSI/TTY text as well as codes,
  156. it will sometimes show stray characters on the screen.  These are
  157. not a problem with RIPspy itself, but rather with the image file;
  158. some codes in the file are improperly coded.  If lines are broken
  159. by carriage returns without preceding backslashes, or other flaws
  160. like this appear in your RIPscrip files, you may not see proper
  161. display.  However, buggy code like this should not be used
  162. anyway, because it will not work under all circumstances.
  163.  
  164.      There are a few commands that RIPspy does not implement,
  165. especially anything that activates a response.  This means that
  166. most RIP_QUERY operations are ignored, except for those that
  167. activate commands.  Similarly, RIP_FILE_QUERY does not work.  The
  168. seldom-used RIP_COPY_REGION command is also not supported at this
  169. time.  If you have need for one of these commands, contact me and
  170. I will probably add it to the viewer.
  171.  
  172.      For those interested, I am planning on offering RIP viewer
  173. libraries based on the RIPspy engine to authors of BBS door
  174. programs.  These will allow them to display RIP locally as well
  175. as remotely.  Contact me for more information.
  176.  
  177.                       YOUR OWN RIP PROGRAMS
  178.  
  179.  
  180.      Obviously, you are interested in RIPscrip graphics, so this
  181. means you are probably a sysop or BBS/door developer.  Now, for
  182. the first time, you can add local display of RIP graphics to your
  183. programs!  My new RIPdrive and RIPlocal add-on libraries make use
  184. of the same RIP-translation algorithms that are contained in
  185. RIPspy.
  186.  
  187.      RIPlocal is a full-fledged library for Turbo C++ or Borland
  188. C++, and it translates RIP display strings into calls to
  189. Borland's BGI library.  You can use it to build programs which
  190. are completely self-contained, even embedding the fonts within
  191. the .EXE file.
  192.  
  193.      If you wish to use other languages, or if you don't want the
  194. overhead of graphics code in your program, you may want to use my
  195. RIPdrive TSR and library combination.  A very small library is
  196. linked in with your code, and the accompanying TSR driver can be
  197. loaded or unloaded by your users at will.  The calls to RIPdrive
  198. are 100% compatible with RIPlocal, so you can switch from one
  199. library to the other as you prefer.
  200.  
  201.      For more information on these and other programs available
  202. from me, e-mail me at zack@pacific.pacific.net or one of the
  203. other addresses listed below.  You can also look for RIPdrive and
  204. RIPlocal on Internet sites and bulletin boards nationwide as
  205. LCLRIPxx.ZIP.
  206.  
  207.                   TECHNICAL SUPPORT / FEEDBACK
  208.  
  209.  
  210.  
  211.      If you run into any problems in the installation or use of
  212. RIPspy, or have suggestions for improvement, feel free to contact
  213. me via E-mail, or even through postal mail.  (Please do not
  214. telephone me unless I give permission, as I may not be available
  215. at the time.)  I may be reached as #3 @11729 or #1458 @1 on
  216. WWIVnet, or #3 @1 on GrapeVine.  My Internet address is
  217. zack@pacific.pacific.net.
  218.  
  219.      My postal address is:
  220.  
  221.                     Zachary Ives
  222.                     14001 Tomki Road
  223.                     Redwood Valley, CA 95470
  224.  
  225.  
  226.      Furthermore, a Zack Ives Software Support sub is available
  227. through The Griffon's Lair on WWIVnet, IceNET, ExpressNET, and
  228. the GrapeVine.  If you wish to subscribe:
  229.  
  230.      SUBTYPE:  ZAKSOFT
  231.      HOST:     11729 (WWIVnet)
  232.                6754  (IceNET)
  233.                1     (ExpressNET)
  234.                1     (GrapeVine)
  235.  
  236.      This is the best way of getting tech support, asking
  237. questions, and communicating with other sysops who are using my
  238. programs.  It is *the place* for support on any of my programs.
  239.  
  240.      For copies of some of the other utilities I have created,
  241. including my RIPspy command-line RIP viewer, please call my home
  242. BBS, The Griffon's Lair, at (707) 526-2184.  You may find more
  243. information and utilities for RIPscrip on The Griffon's Lair, or
  244. on Telegrafix's support BBS, The Vector Sector, at (714) 379-
  245. 2133.  I also plan to make most of my utilities available through
  246. the SimTel archives, accessible through a number of Internet FTP
  247. sites such as oak.oakland.edu.
  248.                             ORDER FORM
  249.                          for RIPspy 1.01
  250.  
  251.  
  252.  
  253. If you are a registered user of my RIPspeed product for WWIV,
  254. registration is free.  Otherwise, please include a check for $10
  255. payable to Zachary Ives.
  256.  
  257.  
  258. Your Name: ______________________________________________________
  259.  
  260.  
  261. Addr.: __________________________________________________________
  262.  
  263.  
  264. City, St, Zip: __________________________________________________
  265.  
  266.  
  267. Voice Phone No.: ________________________
  268.  
  269.  
  270.  
  271. The following information will only be used if I need to contact
  272. you, or to notify you of upgrades:
  273.  
  274.  
  275. Voice Phone No.: ________________________
  276.  
  277.  
  278. E-Mail Address and Network: _____________________________________
  279.  
  280.  
  281. Internet Address, if applicable: ________________________________
  282.  
  283.  
  284. Mail this form, along with the check, to:
  285.  
  286. Zachary Ives
  287. 14001 Tomki Road
  288. Redwood Valley, CA 95470
  289.  
  290.  
  291. Thanks!